package com.example.forum.services;

import com.example.forum.model.Article;
import com.sun.istack.internal.NotNull;
import org.apache.ibatis.annotations.Param;
import org.springframework.transaction.annotation.Transactional;

import java.beans.Transient;
import java.util.List;

/**
 * @InterfaceName IArticleService
 * @Description TODO
 * @Author H.
 * @Date 2023/5/31 16:54
 * @Version 1.0
 */
public interface IArticleService {
    /**
     * 新增帖子
     * @param article 帖子对象
     */
    @Transactional //添加事务，保证在添加帖子成功的同时，板块帖子数和用户发布帖子数量同时更新
    public void create(Article article);

    /**
     * 首页查询所有的帖子
     * @return
     */
    List<Article> selectAll();

    /**
     * 根据版块Id获取该板块下所有的帖子
     * @param boardId
     * @return
     */

    List<Article> selectByBoardId(@Param("boardId") Long boardId);

    /**
     * 根据帖子ID查询帖子详情 
     * @param id
     * @return
     */
    Article selectDetailById(@Param("id") Long id);

    /**
     * 查询帖子信息
     * @param id 帖子id
     * @return 帖子信息
     */
    Article selectById(@Param("id") Long id);

    /**
     * 编辑帖子
     * @param id 帖子Id
     * @param content 帖子内容
     */
    void modify(Long id, String content);

    /**
     * 删除帖子
     * @param id 帖子id
     */
    @Transactional
    void deleteById(Long id);


    /**
     * 根据有用户Id查询文章
     * @param userId 用户Id
     * @return
     */
    List<Article> selectByUserId (@Param("userId") @NotNull Long userId);


    /**
     * 文章点赞
     * @param id 文章id
     */
    void thumbsUpById (Long id);


}
